Hosted lists contain data from the dataset. They can also have their own data fields that are not shared among lists in the dataset, but belong exclusively to the list. Lists that do have their own fields will also have their own web subscription forms generated when the list is created. All the fields that appear in the dataset and in a particular list can be used as merged fields for messages sent to that list.
This screen is split into two frames. The left frame will display all the lists (if any) that belong to the open dataset. Datasets with many lists can use folders called “categories” to organize lists so that they are easier to find. See Section 8
Organizing Datasets for more information.
The right pane shows the actual overview of the dataset settings. Depending on the current user rights, the overview is displayed with two tabs (in case the logged-in user does not have access to the membership area layout customization) or three tabs, with access to the membership area layout customization using the Membership Area Layout tab. The settings overview displays the following details of the dataset:
The shared fields are fields that are common to the dataset and all lists in it. In other words, each list in the dataset has at least those fields defined for the whole dataset, and may optionally add its own fields to these shared fields. The fields are shown with their internal database name (also the merge-field name for that field) and, in parenthesis, their data type. Any mandatory fields are shown as bold. "Mandatory" means that members must fill out a value for these fields when joining the dataset.
Important Note: Once lists have been added to a dataset, some options for editing the dataset will be curtailed. Make sure the dataset is structured as desired before adding lists to it.
Similar to creating a dataset, creating a hosted recipient list is accomplished by using a wizard that guides you through the steps of designing the list and the accompanying web subscription form. To access this wizard, click
Dataset >
Create >
Create Hosted Recipient List from the Toolbar. The Hosted Recipient List Definition wizard opens and it is comprised of four main screens – General, Profile Fields, Profile Field Details, and Summary.
|
•
|
Name – This is the name of the mailing list. Subscribers will see this name for the list on the web form when they subscribe. LISTSERV Maestro users will see the name of the list in the default hosted list target group that is automatically created when the list is populated with subscribers. See Section 13 Hosted Recipient List Target Groups for more details. Data administrators will see the list name in the dataset tree.
|
|
•
|
Internal Description – The internal description is seen by users working within the Maestro User Interface.
|
|
•
|
Public Description – The public description of the list appears on the subscription web form. If subscribers are permitted to select the lists they want to join and can view and change their subscription settings, having accurate descriptions will help them accomplish those tasks.
|
The Profile Fields screen contains a list of the fields in the dataset. New fields can be added to the list. Any added list fields will
not be shared with the other lists in the dataset. To add a new field, click the
Add Field link.
|
•
|
Name – The name of the field as it will be used internally by the system for mail merging and querying. Field names can only use upper and lower case letters A-Z and a-z, the numbers 0 – 9 and the underscore “_”. Spaces and other special characters are not allowed.
|
|
•
|
Display Name – The label that identifies the field on the web form. The display name will be seen by anyone accessing the list’s public subscription page on the Web. All alphanumeric characters are permitted, as well as spaces and most special characters.
|
|
•
|
Data Type – Choose the type of data to be entered in the field from the drop-down menu. Five different classifications of data are available:
|
|
•
|
Text – Text fields can accept any type of text, including dates in specific formats such as dd/mm/yyy or mm.dd.yyyy.
|
|
•
|
Number – Number fields accept any whole integers.
|
|
•
|
Boolean – Boolean fields are based on two states – true or false.
|
|
•
|
Single Select (lookup table) – A single selection field consists of a drop-down menu where one item from it may be chosen. It may also be represented as a set of option buttons.
|
|
•
|
Multiple Select (lookup table) – A multiple selection field consists of a drop-down menu where one or more items may be chosen. It may also be represented as a set of checkboxes.
|
|
•
|
Input Type – Decide whether the data is mandatory for subscribers to enter into the web form or optional. Optional fields can be designated as hidden or read-only if the subscribers are not allowed to enter or change the data in those fields. Boolean fields cannot be optional due to the nature of the data type – the selection equates to either true or false. Boolean fields may be visible or hidden.
|
After list fields are created, they can be edited, removed, moved up, or moved down by using the corresponding links on the right side of the table. Fields that are part of the dataset cannot be moved or edited from this screen.
The Profile Field Details screen has multiple tabs that allow you to toggle between the different settings for list profile fields. The number and type of tabs depends on the types of data fields added to the list.
The Selection Field Details tab only appears if there are profile fields of the Single Select or
Multiple Select type in the dataset or mailing list. In this case, for each of these fields, the lookup table must be specified that will be used to define the values that the subscriber may select from.
This tab displays the name of each such profile field together with a drop-down menu that contains all lookup tables that can be used together with the profile field. Select a lookup table from the drop-down menu to associate it with the corresponding profile field. The description of the selected lookup table appears beneath the drop-down menu so that the selected lookup table can be verified as the desired one. This step needs to be performed for each profile field that has one of the two types listed above.
Notes: It is possible to assign the same lookup table to several different profile fields (if that is desired). In addition, only lookup tables that are using the charset encoding "ASCII" or that are using the same charset encoding as was specified for the dataset (or in case of a list, the encoding that was specified for the dataset the list belongs to) can be selected.
For a dataset that already contains members or lists, or for a list that already contains subscribers, the lookup tables assigned to already existing profile fields can no longer be changed. If a new field is added to such a dataset or list (on the Profile Fields page), then the lookup table for this new field can be assigned, but the lookup tables of the other fields still cannot be changed.
This Input Validation tab only appears if there are any profile fields of the Text type (other than the
EMAIL column of the dataset) or the
Number type in the dataset or mailing list. In this case, the tab allows for optionally defining additional input validation rules for each of these fields. The tab displays the name of each such profile field together with a drop-down menu containing the possible input validation types.
|
•
|
Accept all values – No validation will be applied, all text input is valid (with a maximum length of 100, which is imposed by LISTSERV Maestro). Note that for some encodings, like UTF-8 or asian language encodings, the maximum character length may even be less than 100, depending on the specified value.
|
|
•
|
Date with format – Input will be validated as a date (day, month, and year) according to the date format specified. For the date format, four different formats are available:
|
|
•
|
yyyy-mm-dd – Year, followed by month, followed by day, separated by a hyphen.
|
|
•
|
mm/dd/yyyy – Month, followed by day, followed by year, separated by a slash.
|
|
•
|
dd/mm/yyyy – Day, followed by month, followed by year, separated by a slash.
|
|
•
|
dd.mm.yyyy – Day, followed by month, followed by year, separated by a dot.
|
|
•
|
Full Name – Input will only be accepted if it can be interpreted as a valid "Full Name", meaning a first name followed by a last name. To fulfill this requirement, the input must consists of at least two text strings separated by at least one space character. Examples for valid "Full Names" include: "John Doe", "Frank N. Furter", "Dr. Dolittle" but also "a b".
|
|
•
|
String length range – Text input will be validated so that the entered text is no shorter than the supplied minimum length and no longer than the supplied maximum length. Minimum and maximum length can both be the same value, in which case the entered text must have exactly the given length. Any input that does not fall into the given length range is not accepted. The given minimum must be 1 or more, the given maximum must be 100 or less, and the maximum must not be less than the minimum. Note that for an optional field an empty input is also accepted.
|
|
•
|
String length minimum – Text input will be validated so that the entered text is no shorter than the supplied minimum length. Any input that is less than this value is not accepted. The given minimum must be between 1 and 100 (including). Note that for an optional field an empty input is also accepted.
|
|
•
|
String length maximum – Text input will be validated so that the entered text is no longer than the supplied maximum length. Any input that is greater than this value is not accepted. The given maximum must be between 1 and 100 (including). Note that for an optional field an empty input is also accepted.
|
|
•
|
Accept all values – No validation will be applied, all number input is valid (in the range of -9223372036854775808 to 9223372036854775807, which is imposed by LISTSERV Maestro).
|
|
•
|
Number range – Number input will be validated so that the entered number is not less than the supplied minimum and not greater than the supplied maximum. Any input that does not fall into the given range is not accepted. The given minimum must be less than the given maximum. Note that for an optional field an empty input is also accepted.
|
|
•
|
Number minimum – Number input will be validated so that the entered number is not less than the supplied minimum. Any input that is less than the minimum is not accepted. Note that for an optional field an empty input is also accepted.
|
|
•
|
Number maximum – Number input will be validated so that the entered number is not greater than the supplied maximum. Any input that is greater than the maximum is not accepted. Note that for an optional field an empty input is also accepted.
|
Note: For a dataset that already contains members or lists, or for a list which already contains subscribers, then the input validation of already existing profile fields can no longer be changed. If a new field is added to such a dataset or list (on the Profile Fields page), then the input validation for this new field can be defined, but the input validation of the other fields still cannot be changed.
The Subscriber Name Definition tab only appears if there is at least one profile field of Text type defined (other than the
EMAIL field of the dataset) either in the profile fields of the hosted recipient list or in the shared profile fields of the dataset.
This tab also allows you to define what value to use as the recipient name in the To field of all mailings to this hosted recipient list. The value that is to be used as the recipient name can be a single
Text type profile field (containing the recipient's name), or it can be a combination of several
Text or
Single Select type profile fields (but at least one
Text field). If a combination of several fields is used, then they will be appended to each other in the given order with a separating space between each. This is used to construct the actual recipient name to be used in the
To field.
If you have a FIRST_NAME field, a
LAST_NAME field, and a single select
Title field, then you might want to specify all three in the following order:
Note: If several fields are appended to construct the full name, then they are separated by a space. However, if one of the fields is optional and there is no value provided, then no additional space will be inserted; this means that, between two values in the full name, there will only ever be a single space (unless more spaces have been specified somewhere "inside" of a value).
To define a profile field to be included in the name definition, select it in the Profile Fields field (left selection box), then click
[->] to move the field into the
Name Fields field (right selection box). To again remove a profile field from the name definition, select it in the right box and click
[<-]. To change the ordering of the profile fields in the right selection box, select a field in the box and then click the
Move Up or
Move Down link.
The Default Values tab is only visible when modifying a dataset or list that already contains subscribers and additional profile fields on the Profile Fields screen have been added. In this case, it is necessary to define defaults for the new fields that will be used for the already existing subscribers.
This tab lists all fields that have been added. Each field has a Define link. Click the link to define the default value for the given field. (For fields of the
Single or
Multiple Select type, before the default can be defined, a lookup table must first be assigned on the Selection Field Details tab.)
If the field is of the Multiple Select type (or
"visible", which is a variation of
Mandatory), then a default will have to be supplied before leaving the wizard. For optional fields (or
"read-only" or
"hidden", which are variations of
Optional), then a default doesn't need to be supplied. If the default of such a field is left empty, then the empty value will be used for all existing subscribers.
The Summary screen displays all of the settings for the list. You can set the access level for the list by selecting one of the options in the
Public List Access drop-down menu. Lists that are
Open to everyone can be subscribed to from the dataset web form or the list web form. Anyone with the URL to either form can access the list subscription page. Lists that have
Access for subscribers only are visible to subscribers who have been added to the list by the data Administrator. The list will not be displayed on the dataset web form when accessed by a non-subscriber. Lists with
No public access will not appear to non-subscribers or subscribers from the dataset web form. This setting can be used when a list is under construction to prevent anyone from signing up prematurely.
Use the [<- Back] button to return to the previous screen. Click
[Finish] to save the list and return to the Recipient Dataset Details screen. After a hosted recipient list has been added to the dataset, it will appear in the dataset tree in the left frame represented by this icon and accompanied by the list name.
